home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / win / c / clikbar.exe / CLICKBAR.DOC < prev    next >
Text File  |  1992-05-19  |  44KB  |  1,050 lines
  1.  
  2.      Credits
  3.      ──────────────────────────────────────────────────────────────────────
  4.  
  5.      ClickBar, ClickDlg, and WynBtn were written by Dave Campbell.       
  6.  
  7.      The ClickBar toolkit was developed using the Borland C++ 3.0 Windows
  8.      Development package.
  9.  
  10.  
  11.      Copyright Notice
  12.      ──────────────────────────────────────────────────────────────────────
  13.  
  14.      Clickbar, ClickDlg, and WynBtn are Copyright 1992 by WynApse Software.
  15.      All rights are reserved.
  16.  
  17.      This document is Copyright 1992 by WynApse Software.
  18.      All rights are reserved.
  19.  
  20.  
  21.      Trademarks
  22.      ──────────────────────────────────────────────────────────────────────
  23.  
  24.      Clickbar, ClickDlg, and WynBtn are trademarks of WynApse Software.
  25.  
  26.      All trademarks and registered trademarks referenced within this
  27.      document are the property of their respective holders.
  28.  
  29.  
  30.      Warranty Disclaimer
  31.      ──────────────────────────────────────────────────────────────────────
  32.  
  33.      WYNAPSE SOFTWARE MAKES NO WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED,
  34.      INCLUDING WITHOUT LIMITATION ANY WARRANTIES OF MERCHANTABILITY AND/OR
  35.      FITNESS FOR A PARTICULAR PURPOSE.
  36.  
  37.      WYNAPSE SOFTWARE DOES NOT ASSUME ANY LIABILITY FOR THE USE OF THIS
  38.      SOFTWARE BEYOND THE ORIGINAL PURCHASE PRICE OF THIS SOFTWARE.
  39.  
  40.      IN NO EVENT WILL WYNAPSE SOFTWARE BE LIABLE TO YOU FOR ANY ADDITIONAL
  41.      DAMAGES, INCLUDING ANY LOST PROFITS, LOST SAVINGS, OR OTHER INCIDENTAL
  42.      OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OF, OR INABILITY TO USE,
  43.      THIS SOFTWARE AND ITS ACCOMPANYING DOCUMENTATION, EVEN IF WYNAPSE
  44.      SOFTWARE, OR ANY AGENT OF WYNAPSE SOFTWARE HAS BEEN ADVISED OF THE 
  45.      POSSIBILITY OF SUCH DAMAGES.
  46.  
  47.  
  48.      Table of Contents
  49.      ──────────────────────────────────────────────────────────────────────
  50.  
  51.      Installation. . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  52.         Extracting Files. . . . . . . . . . . . . . . . . . . . . . . .   1
  53.         Installing Files into Windows . . . . . . . . . . . . . . . . .   1
  54.  
  55.      Version 1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . .    2
  56.         Introduction . . . . . . . . . . . . . . . . . . . . . . . . .    2
  57.         ClickBar.DLL . . . . . . . . . . . . . . . . . . . . . . . . .    2
  58.         ClickDlg.DLL . . . . . . . . . . . . . . . . . . . . . . . . .    2
  59.         TestClik.EXE . . . . . . . . . . . . . . . . . . . . . . . . .    2
  60.         ClikTest.EXE . . . . . . . . . . . . . . . . . . . . . . . . .    2
  61.         Included Files . . . . . . . . . . . . . . . . . . . . . . . .    3
  62.  
  63.      Accessing ClickDlg. . . . . . . . . . . . . . . . . . . . . . . .    4 
  64.         Introduction . . . . . . . . . . . . . . . . . . . . . . . . .    4
  65.         .C Program Header. . . . . . . . . . . . . . . . . . . . . . .    4
  66.         .C Program WinMain . . . . . . . . . . . . . . . . . . . . . .    5
  67.            Loading DLLs. . . . . . . . . . . . . . . . . . . . . . . .    5
  68.            Far Procedure Address Assignment. . . . . . . . . . . . . .    6
  69.            DLL End User Registration . . . . . . . . . . . . . . . . .    7
  70.            ClickDlg Setup call . . . . . . . . . . . . . . . . . . . .    8
  71.            ClickDlg Execution. . . . . . . . . . . . . . . . . . . . .    8
  72.            Freeing DLLs. . . . . . . . . . . . . . . . . . . . . . . .    8
  73.         .C Program WndProc . . . . . . . . . . . . . . . . . . . . . .    8
  74.            WM_SIZE and WM_MOVE . . . . . . . . . . . . . . . . . . . .    8
  75.            WM_COMMAND. . . . . . . . . . . . . . . . . . . . . . . . .    9
  76.         .RC File . . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  77.         .DLG File. . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  78.  
  79.      DLL bitmaps vs. binding bitmaps . . . . . . . . . . . . . . . . .   11
  80.         Button Profiles. . . . . . . . . . . . . . . . . . . . . . . .   11
  81.  
  82.      ClickBar and the Resource Workshop. . . . . . . . . . . . . . . .   12
  83.         Installing ClickBar.DLL. . . . . . . . . . . . . . . . . . . .   12
  84.         Using the custom controls. . . . . . . . . . . . . . . . . . .   12
  85.         Button Types . . . . . . . . . . . . . . . . . . . . . . . . .   13
  86.         Button ID. . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  87.         Background Color . . . . . . . . . . . . . . . . . . . . . . .   13
  88.  
  89.      User Registration . . . . . . . . . . . . . . . . . . . . . . . .   14
  90.         WYNAPSE.INI. . . . . . . . . . . . . . . . . . . . . . . . . .   15
  91.         End User Use . . . . . . . . . . . . . . . . . . . . . . . . .   16
  92.  
  93.      Windows 3.1 . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  94.  
  95.      Borland C++ . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  96.  
  97.      Registration. . . . . . . . . . . . . . . . . . . . . . . . . . .   17
  98.  
  99.      ClickBar 1.0 ORDER FORM . . . . . . . . . . . . . . . . . . . . .   18
  100.  
  101.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   19
  102.  
  103.  
  104.      Installation
  105.      ──────────────────────────────────────────────────────────────────────
  106.  
  107.  
  108.         Extracting Files
  109.         ────────────────
  110.  
  111.      Build a "scratch" directory, preferably on a large RAM disk, that will
  112.      be used to temporarily extract the delivered ClickBar files.  For
  113.      example, 
  114.  
  115.           C> cd \ <return>
  116.           C> md scratch <return>
  117.           C> cd scratch <return>
  118.  
  119.      Copy the ClikBar1.ZIP file from the source diskette to the scratch
  120.      directory:
  121.  
  122.           C> copy <diskette name>:\clikbar1.ZIP <return>
  123.  
  124.      Execute Pkunzip to extract the two main files:
  125.  
  126.           C> PKUNZIP CLIKBAR1 <return>
  127.      
  128.      Read the Read.Me file for any last-minute additions:
  129.   
  130.           C> type read.me|more <return>
  131.  
  132.  
  133.         Installing Files into Windows
  134.         ─────────────────────────────
  135.  
  136.      Start Windows, and from the Program Manager screen, execute 
  137.  
  138.           "File" "Run" C:\SCRATCH\SETUP.  
  139.  
  140.      Setup will propose a directory in which to install Clickbar.  If the
  141.      proposed directory is unacceptable, change it as necessary, and press
  142.      OK.  Setup will install ClickBar, and build a screen group named
  143.      WynApse for the TestClik and ClikTest programs. This will also provide
  144.      a convenient group for any test programs constructed using the
  145.      toolbar.  
  146.      
  147.      When SETUP is finished, and you next return to DOS, remove all the files 
  148.      from the scratch directory, and delete the directory:
  149.  
  150.           C> cd \scratch <return>
  151.           C> del *.* <return>
  152.  
  153.      answer "Y" to the question about deleting all the files, then:
  154.  
  155.           C> cd \ <return>
  156.           C> rd scratch <return>
  157.  
  158.  
  159.      Version 1.0
  160.      ──────────────────────────────────────────────────────────────────────
  161.  
  162.  
  163.         Introduction
  164.         ────────────
  165.  
  166.      This document is the manual for ClickBar and ClickDlg.  These two tools
  167.      are built for Microsoft Windows developers to use in producing 
  168.      Windows applications with full-featured tool bars.
  169.  
  170.  
  171.         ClickBar.DLL
  172.         ────────────
  173.  
  174.      ClickBar v1.0 is delivered with 144 3-dimensional bitmapped buttons to 
  175.      be used in any combination to provide users an exciting toolbar concept
  176.      instead of the standard pull-down menus.  75 of the buttons are "bound
  177.      into" the dynamic link library CLICKBAR.DLL, and the remainder are
  178.      provided as bitmaps for the developer to bind into the application, if
  179.      desired.
  180.  
  181.      See the section entitled "DLL bitmaps vs. binding bitmaps" for 
  182.      information and instructions on the available options.
  183.  
  184.  
  185.         ClickDlg.DLL
  186.         ────────────
  187.  
  188.      ClickDlg is the dynamic link library that provides the toolbar 
  189.      interface itself to the user's application.  A straight-forward, 
  190.      40-line addition to an existing application will provide the user 
  191.      with a toolbar interface.  
  192.    
  193.  
  194.         TestClik.EXE
  195.         ────────────
  196.  
  197.      ClickBar is delivered with a demonstration, "TestClik.EXE".  The 
  198.      source code is included for TESTCLIK, and the section entitled
  199.      "Accessing Cl